Skip to main content
POST
Send a probe bid request to an ad source

Authorizations

Authorization
string
header
required

Bearer authentication. Pass the access token in the Authorization: Bearer <token> header.

Body

application/json

POST /allocations/bid-request-probes request body.

ad_source_id
string<uuid>
required

Ad source to send the test bid request to

allocation_ext
AllocationExt · object
required

Allocation ext under test

environment
enum<string>
required

Environment to test — web or app

Available options:
web,
app
platform
enum<string>
required

Device platform to test. It picks the User-Agent and device.os sent to the vendor in both environments, and for app it also picks which bundle (ios_bundle or android_bundle) is sent.

Available options:
ios,
android
tid
string<uuid>
required

Target ID

ttype
enum<string>
required

Target type — only ad_unit is supported

Available options:
ad_unit,
placement

Response

Successful Response

실제로 보낸 BidRequest와 벤더 응답.

벤더가 4xx/5xx를 돌려줘도 이 응답은 200이다. 벤더의 거절은 테스트 실패가 아니라 테스트 결과다.

bid_request
Bid Request · object
required

BidRequest body that was sent

elapsed_ms
integer
required

Round-trip time in milliseconds, including DNS, TCP and TLS setup. Not comparable to the edge server's read timeout, which is applied to the read stage alone over a pooled connection.

body
string | null

Raw response body from the ad source, capped at 16000 bytes while reading — a body longer than that is cut off mid-download

error
string | null

Transport-level failure as ExceptionClass: message — the class name separates a connect timeout from a read timeout, which share the same message

status_code
integer | null

HTTP status returned by the ad source — null if unreachable